<!doctype html>
<html lang="zh-CN"><head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
    <title>薛尧的博客</title>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
    <meta name="description" content="" />

    
    
    
    <link rel="stylesheet" href="../../../css/theme.min.css">

    
    
    
    
    <link rel="stylesheet" href="../../../css/custom.min.css">
    

    
</head>
<body>
        <div id="content" class="mx-auto"><header class="container mt-sm-5 mt-4 mb-4 mt-xs-1">
    <div class="row">
        
        <div class="col-sm-4 col-12 text-sm-right text-center pt-sm-4">
            <a href="../../../" class="text-decoration-none">
                <img id="home-image" class="rounded-circle"
                    
                        src="https://ueyao.github.io/image-hosting/blog/avatar.png"
                    
                />
            </a>
        </div>
        <div class="col-sm-8 col-12 text-sm-left text-center">
        
            <h2 class="m-0 mb-2 mt-4">
                <a href="../../../" class="text-decoration-none">
                    
                        薛尧
                    
                </a>
            </h2>
            <p class="text-muted mb-1">
                
                    Java Developer | Short Video Creator
                
            </p>
            <ul id="nav-links" class="list-inline mb-2">
                
                
                    <li class="list-inline-item">
                        <a class="badge badge-white " href="../../../about/" title="关于">关于</a>
                    </li>
                
                    <li class="list-inline-item">
                        <a class="badge badge-white " href="../../../post/" title="文章">文章</a>
                    </li>
                
                    <li class="list-inline-item">
                        <a class="badge badge-white " href="../../../categories/" title="分类">分类</a>
                    </li>
                
            </ul>
            <ul id="nav-social" class="list-inline">
                
                    <li class="list-inline-item mr-3">
                        <a href="http://github.com/flowstone" target="_blank">
                            <i class="fab fa-github fa-1x text-muted"></i>
                        </a>
                    </li>
                
                    <li class="list-inline-item mr-3">
                        <a href="mailto:xueyao.me#gmail.com" target="_blank">
                            <i class="fas fa-at fa-1x text-muted"></i>
                        </a>
                    </li>
                
            </ul>
        </div>
    </div>
    <hr />
</header>
<div class="container">
    <div class="pl-sm-2">
        <div class="mb-3">
            <h3 class="mb-0">Docker入门-Dockerfile的使用</h3>
            
            <small class="text-muted">发布于 2019-08-14</small>
        </div>

        <article>
            <h2 id="使用dockerfile定制镜像">使用Dockerfile定制镜像</h2>
<p>镜像的定制实际上就是定制每一层所添加的配置、文件。我们可以把每一层修改、安装、构建、操作的命令都写入一个脚本，这个脚本就是Dockerfile。</p>
<p>Dockerfile是一个文本文件，其内包含了一条条的指令，每一条指令构建一层，因此每一条指令的内容，就是描述该层应当如何构建。</p>
<p>接下来我们以官方nginx镜像为例，使用Dockerfile来定制。</p>
<p>在一个空白目录中，建立一个文本文件，并命名为Dockerfile:</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>mkdir mynginx
</span></span><span style="display:flex;"><span>cd mynginx
</span></span><span style="display:flex;"><span>touch Dockerfile
</span></span></code></pre></div><p>其内容为：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>FROM nginx
</span></span><span style="display:flex;"><span>RUN echo <span style="color:#e6db74">&#39;&lt;h1&gt; Hello,Docker!&lt;/h1&gt;&#39;</span> &gt;/usr/share/nginx/html/index.html
</span></span></code></pre></div><p>这个Dockerfile很简单，一共就两行。涉及到了两条指令，FROM和RUN。</p>
<h3 id="from指定基础镜像">FROM指定基础镜像</h3>
<p>所谓定制镜像，一定是以一个镜像为基础，在其上进行定制。基础镜像是必须指定的，而FROM就是指定基础镜像，因此一个Dockerfile中FROM是必备的指令，并且必须是第一条指令。在Docker Hub上有非常多的高质量的官方镜像，有可以直接拿来使用的服务类的镜像，如nginx、redis、mysql、tomcat等；可以在其中寻找一个最符合我们最终目标的镜像为基础镜像进行定制。</p>
<p>如果没有找到对应服务的镜像，官方镜像中还提供了一些更为基础的操作系统镜像，如ubuntu、debian、centos、alpine等，这些操作系统的软件库为我们提供了更广阔的扩展空间。</p>
<p>除了选择现有镜像为基础镜像外，Docker还存在一个特殊的镜像，名为scratch。这个镜像是虚拟的概念，并不实际存在，它表示一个空白的镜像。</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>FROM scratch
</span></span><span style="display:flex;"><span>...
</span></span></code></pre></div><p>如果你以scratch为基础镜像的话，意味着你不以任何镜像为基础，接下来所写的指令将作为镜像第一层开始存在。</p>
<p>对于Linux下静态编译的程序来说，并不需要有操作系统提供运行时支持，所需的一切库都已经在可执行文件里了，因此直接FROM scratch会让镜像体积更加小巧。使用Go语言开发的应用很多会使用这种方式来制作镜像，这也是为什么有人认为Go是特别适应容器微服务架构的语言的原因之一。</p>
<h3 id="run执行命令">RUN执行命令</h3>
<p>RUN指令是用来执行命令行命令的。由于命令行的强大能力，RUN指令在定制镜像时是最常用的指令之一。其格式有两种：</p>
<p>shell格式：RUN &lt;命令&gt;</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>RUN echo <span style="color:#e6db74">&#39;&lt;h1&gt;Hello,Docker~&lt;/h1&gt;&#39;</span> &gt; /usr/share/nginx/html/index.html
</span></span></code></pre></div><p>exec格式： RUN [&ldquo;可执行文件&rdquo;,“参数1”,“参数2”]</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>RUN tar -xzf redis.tar.gz -C /usr/src/redis --strip-components<span style="color:#f92672">=</span><span style="color:#ae81ff">1</span>
</span></span><span style="display:flex;"><span>RUN make -C /usr/src/redis
</span></span><span style="display:flex;"><span>RUN make -C /usr/src/redis install
</span></span></code></pre></div><p>上面我们利用Dockerfile定制了nginx镜像，现在我们明白了这个Dockerfile的内容，接下来我们来构建这个镜像。</p>
<p>在Dockerfile文件所在目录执行:</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>docker build -t nginx:v3 .
</span></span></code></pre></div><p>从命令的输出结果中，我们可以清晰的看到镜像的构建过程。在Step2中，RUN指令启动了一个容器782d25b7c611,执行了所要示的命令，并最后提交了这一层ba38ff665f57,随后删除了所用到的这个容器782d25b7c611。</p>
<p><img src="https://ueyao.github.io/image-hosting/blog/20191214172011541.png" alt="dockerfile构建"></p>
<p>启动构建的Nginx</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>docker run --name nginx-test -p 8081:80 -d nginx:v3
</span></span></code></pre></div><p>如图所示</p>
<p><img src="https://ueyao.github.io/image-hosting/blog/20191214172033511.png" alt="docker启动nginx容器"></p>
<h2 id="dockerfile指令详解">Dockerfile指令详解</h2>
<h4 id="copy复制文件">COPY复制文件</h4>
<p>格式：</p>
<ul>
<li>COPY &lt;源路径&gt;&hellip;&lt;目标路径&gt;</li>
<li>COPY [&quot;&lt;源路径1&gt;&quot;,&hellip;&quot;&lt;目标路径&gt;&quot;]</li>
</ul>
<p>COPY指令将从构建上下文目录中&lt;源路径&gt;的文件/目录复制到新的一层的镜像内的&lt;目标路径&gt;位置。比如：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>COPY package.json /usr/src/app/
</span></span></code></pre></div><p>&lt;源路径&gt;可以是多个，甚至可以是通配符，如：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>COPY hom* /mydir/
</span></span><span style="display:flex;"><span>COPY hom?.txt /mydir/
</span></span></code></pre></div><h4 id="add更高级的复制文件">ADD更高级的复制文件</h4>
<p>ADD指令和COPY的格式和性质基本一致。但是在COPY基础上增加了一些功能。比如&lt;源路径&gt;可以是一个URL,这种情况下，Docker引擎会试图去下载这个链接的文件放到&lt;目标路径&gt;去。</p>
<p>在Docker官方的Dockerfile最佳实践文档中要求，尽可能的使用COPY，因此COPY的语义很明确，就是复制文件而已，而ADD则包含了更复杂的功能，其行为也不一定很清晰。最适合使用ADD的场合，就是所提及的需要自动解压缩的场合。</p>
<p>因此在COPY和ADD指令中选择的时候，可以遵循这样的原则，所有的文件复制均使用COPY指令，仅在需要自动解压缩的场合使用ADD。</p>
<h4 id="cmd容器启动命令">CMD容器启动命令</h4>
<p>CMD指令的格式和RUN相似，也是两种格式：</p>
<ul>
<li>shell格式：CMD &lt;命令&gt;</li>
<li>exec格式：CMD [&ldquo;可执行文件&rdquo;,“参数1”,“参数2”]</li>
<li>参数列表格式：CMD [“参数1”,“参数2”&hellip;]。在指定了ENTRYPOINT指令后，用CMD指定具体参数。</li>
</ul>
<p>Docker不是虚拟机，容器就是进程。既然是进程，那么在启动容器的时候，需要指定所运行的程序及参数。CMD指令就是用于指定默认的容器主进程启动命令的。</p>
<h4 id="entrypoint入口点">ENTRYPOINT入口点</h4>
<p>ENTRYPOINT的目的和CMD一样，都是在指定容器启动程序及参数。ENTRYPOINT在运行也可以替代，不过比CMD要略显繁琐，需要通过docker run的参数 &ndash;entrypoint来指定。</p>
<p>当指定了ENTRYPOINT后，CMD的含义就发生了改变，不再是直接的运行其命令，而是将CMD的内容作为参数传给ENTRYPOINT指令，换句话说实际执行时，将变为：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>&lt;ENTRYPOINT&gt;<span style="color:#e6db74">&#34;&lt;CMD&gt;&#34;</span>
</span></span></code></pre></div><h4 id="env设置环境变量">ENV设置环境变量</h4>
<p>格式有两种：</p>
<ul>
<li>ENV <!-- raw HTML omitted --><!-- raw HTML omitted --></li>
<li>ENV <!-- raw HTML omitted -->=<!-- raw HTML omitted --><!-- raw HTML omitted -->=<!-- raw HTML omitted -->&hellip;</li>
</ul>
<p>这个指令很简单，就是设置环境变量而已，无论是后面的其它指令，如RUN，还是运行时的应用，都可以直接使用这里定义的环境变量。</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>ENV VERSION<span style="color:#f92672">=</span>1.0 DEBUG<span style="color:#f92672">=</span>on NAME<span style="color:#f92672">=</span><span style="color:#e6db74">&#34;Happy Feet&#34;</span>
</span></span><span style="display:flex;"><span>$VERSION <span style="color:#75715e">#使用环境变量</span>
</span></span></code></pre></div><p>下列指令可以支持环境变量展开：ADD、COPY、ENV、EXPOSE、LABEL、USER、WORKDIR、VOLUME、STOPSIGNAL、ONBUILD。</p>
<h4 id="arg构建参数">ARG构建参数</h4>
<p>格式：</p>
<ul>
<li>ARG &lt;参数名&gt;[=&lt;默认值&gt;]
构建参数和ENV的效果一样，都是设置环境变量。所不同的是，ARG所设置的构建环境的环境变量，在将来容器运行时是不会存在这些环境变量的。但是不要因此就使用ARG保存密码之类的信息，因此docker history还是可以看到所有值的。</li>
</ul>
<p>Dockerfile中的ARG指令是定义参数名称，以及定义其默认值。该默认值可以在构建命令docker build中用 &ndash;build-arg &lt;参数名&gt;=&lt;值&gt;来覆盖。</p>
<h4 id="volume定义匿名卷">VOLUME定义匿名卷</h4>
<p>格式为：</p>
<ul>
<li>VOLUME [&quot;&lt;路径1&gt;&quot;,&quot;[路径2]&quot;&hellip;]</li>
<li>VOLUME &lt;路径&gt;</li>
</ul>
<p>容器运行时应该尽量保持容器存储层不发生写操作，对于数据库需要保存动态数据的应用，其数据库文件应该保存于卷(volume)中，为了防止运行时用户忘记将动态文件所保存目录挂载为卷，在Dockerfile中,我们可以事先指定某些目录挂载为匿名卷，这样在运行时如果用户不指定挂载，其应用也可以正常运行，不会向容器存储层写入大量数据</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>VOLUME /data
</span></span></code></pre></div><p>这里的/data目录就会在运行时自动挂载为匿名卷，任何向/data中写入的信息都不会记录进容器存储层，从而保证了容器存储层的无状态化。当然，运行时可以覆盖这个挂载设置。</p>
<p>比如：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>docker run -d -v mydata:/data xxxx
</span></span></code></pre></div><p>在这行命令中，就使用了mydata这个命名卷挂载到了/data这个位置，替代了Dockerfile中定义的匿名卷的挂载配置。</p>
<h4 id="expose声明端口">EXPOSE声明端口</h4>
<p>格式为EXPOSE &lt;端口1&gt;[&lt;端口2&gt;&hellip;]。</p>
<p>EXPOSE指令是声明运行时容器提供服务端口，这只是一个声明，在运行时并不会因为这个声明应该就会开启这个端口的服务。</p>
<p>在Dockerfile中写入这样的声明有两个好处：</p>
<ol>
<li>是帮助镜像使用者理解这个镜像服务的守护端口，以方便配置映射；</li>
<li>在运行是使随机端口映射时，也就是docker run -P时，会自动随机映射EXPOSE端口。</li>
</ol>
<h4 id="workdir指定工作目录">WORKDIR指定工作目录</h4>
<p>格式为WORKDIR &lt;工作目录路径&gt;</p>
<p>使用WORKDIR指令可以来指定工作目录(或者称为当前目录),以后各层的当前目录就被改为指定的目录，如该目录不存在，WORKDIR会帮你建立目录。</p>
<p>之前提到一些初学者常犯的错误是把Dockerfile等同于Shell脚本来书写，这种错误的理解还可能会导致出现下面这样的错误：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>RUN cd /app
</span></span><span style="display:flex;"><span>RUN echo <span style="color:#e6db74">&#34;hello&#34;</span>&gt;world.txt
</span></span></code></pre></div><p>如果将这个Dockerfile进行构建镜像运行后，会发现找不到 /app/world.txt文件。</p>
<p>原因</p>
<p>在Shell中，连续两行是同一个进程执行环境，因此前一个命令修改的内存状态，会直接影响后一个命令。</p>
<p>而在Dockerfile中，这两行RUN命令的执行环境根本不同，是两个完全不同的容器。这就是对Dockerfile构建分层存储的概念不了解导致的错误。</p>
<p>每一个RUN都是启动一个容器、执行命令、然后提交存储层文件变量。第一层RUN cd /app的执行仅仅是当前进程的工作目录变量，一个内存上的变化而已，其结果不会造成任何文件变更。而到第二层的时候，启动的是一个全新的容器，跟第一层的容器更完全没关系，自然不可能继承前一层构建过程中的内存变化。</p>
<p>因此如果需要改变以后各层的工作目录的位置，那么应该使用WORKIDR指令。</p>
<h4 id="user指定当前用户">USER指定当前用户</h4>
<p>格式：USER &lt;用户名&gt;</p>
<p>USER指令和WORKDIR相似，都是改变环境状态并影响以后的层。WORKDIR是改变工作目录，USER则是改变之后层的执行RUN，CMD以及ENTRYPOINT这类命令的身份。</p>
<p>当前，和WORKDIR一样，USER只是帮助你切换到指定用户而已，这个用户必须是事先建立好的，否则无法切换。</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>RUN groupadd -r redis <span style="color:#f92672">&amp;&amp;</span> useradd -r -g redis redis
</span></span><span style="display:flex;"><span>USER redis
</span></span><span style="display:flex;"><span>RUN <span style="color:#f92672">[</span><span style="color:#e6db74">&#34;redis-server&#34;</span><span style="color:#f92672">]</span>
</span></span></code></pre></div><h4 id="healthcheck健康检查">HEALTHCHECK健康检查</h4>
<p>格式：</p>
<ul>
<li>HEALTHCHECK [选项] CMD &lt;命令&gt;:设置检查容器健康状况的命令</li>
<li>HEALTHCHECK NONE：如果基础镜像有健康检查指令，可以屏蔽掉其健康检查指令</li>
</ul>
<p>HEALTHCHECK指令是告诉Docker应该如何进行判断容器的状态是否正常，这是Docker1.12引入的新指令。通过该指令指定一行命令，用这行命令来判断容器主进程的服务状态是否还正常，从而比较真实的反应容器实际状态。</p>
<p>一个镜像指令HEALTHCHECK指令后，用其启动容器，初始状态会为starting,在执行健康检查成功后变为healthy,如果连续一定次数失败，则会变为unhealthy。</p>
<p>HEALTHCHECK支持下列选项：</p>
<ul>
<li>&ndash;interval=&lt;间隔&gt;:两次健康检查的间隔，默认为30秒；</li>
<li>&ndash;timeout=&lt;时长&gt;:健康检查命令运行超时时间，如果超过这个时间，本次健康检查就被视为失败，默认30秒；</li>
<li>&ndash;retries=&lt;次数&gt;：当连续失败指定次数后，则将容器状态视为unhealthy,默认3次。</li>
</ul>
<p>为了帮助排障，健康检查命令的输出(包括stdout以及stderr)都会被存储于健康状态里，可以用docker inspect来查看。</p>
<h4 id="onbuild为他人做嫁衣裳">ONBUILD为他人做嫁衣裳</h4>
<p>格式： ONBUILD &lt;其它指令&gt;
ONBUILD是一个特殊的指令，它后面跟的是其它指令，比如RUN,COPY等，而这些指令，在当前镜像构建时并不会被执行。只有当以前镜像为基础镜像，去构建下一级镜像的时候才会被执行。</p>
<p>Dockerfile中的其它指令都是为了定制当前镜像而准备的，唯有ONBUILD是为了帮助别人定制自己而准备的。</p>
<h3 id="其他制作镜像方式">其他制作镜像方式</h3>
<h4 id="docker-save和docker-load">docker save和docker load</h4>
<p>Docker还提供了docker load和docker save命令，用以将镜像保存为一个tar文件，然后传输到另一个位置上，再加载进来。这是在没有Docker Registry时的做法，现在已经不推荐，镜像迁移应该直接使用Docker Registry，无论是直接使用Docker Hub还是使用内网私有Registry都可以。</p>
<p>例如：保存nginx镜像</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>docker save nginx|gzip &gt; nginx-latest.tar.gz
</span></span></code></pre></div><p>然后我们将nginx-latest.tar.gz文件复制到了另一个机器上，再次加载镜像：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>docker load -i nginx-latest.tar.gz
</span></span></code></pre></div>
        </article>
    </div>

    <div id="disqus_thread"></div>
<script>
    window.disqus_config = function () {
    
    
    
    };
    (function() {
        if (["localhost", "127.0.0.1"].indexOf(window.location.hostname) != -1) {
            document.getElementById('disqus_thread').innerHTML = 'Disqus comments not available by default when the website is previewed locally.';
            return;
        }
        var d = document, s = d.createElement('script'); s.async = true;
        s.src = '//' + "xie-yao-de-bo-ke" + '.disqus.com/embed.js';
        s.setAttribute('data-timestamp', +new Date());
        (d.head || d.body).appendChild(s);
    })();
</script>
<noscript>Please enable JavaScript to view the <a href="https://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>
<a href="https://disqus.com" class="dsq-brlink">comments powered by <span class="logo-disqus">Disqus</span></a>

            </div>
        </div><footer class="text-center pb-1">
    <small class="text-muted">
        
        &copy; Copyright 2024
        
        |
        <a href="https://beian.miit.gov.cn/" target="_blank">苏ICP备14012079号</a>
        <br />
        由 <a href="https://gohugo.io/" target="_blank">Hugo</a> 强力驱动
        | 主题 <a href="https://github.com/austingebauer/devise" target="_blank">Devise</a>
        <br />

    </small>
</footer></body>
</html>
